home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / comm / bbs / FndFish2.lha / FindFish.doc < prev    next >
Text File  |  1993-06-29  |  6KB  |  184 lines
  1. June 27/93
  2.  
  3. ===========================================================================
  4.  
  5.                         FindFish.c V2.0
  6.  
  7.                   CNet C Pfile for CNet V2.63
  8.  
  9.                   Copyright © 1993 Alan Kramer
  10.  
  11.               This version is freely distributable.
  12.  
  13.  
  14. Check the end of this doc file for information on the REGISTERED version!
  15.  
  16. ===========================================================================
  17.  About the program:
  18.  
  19.  - FindFish is a program to search and display information from the
  20.    contents files of the Fred Fish library.
  21.  
  22.  Features include:
  23.  
  24.  - FindFish will display the complete contents text for a given disk
  25.    or range of disks.
  26.  
  27.  - FindFish will search for 'text' strings in the title text and file
  28.    description text, then displays the contents text for that file,
  29.    also works with ranges.
  30.  
  31.  Ranges:
  32.  
  33.  A range can be a single disk number:
  34.    ie. 214
  35.    The command will operate on disk 214 only. 
  36.  
  37.  A range can cover multiple disks:
  38.    ie. 214,220,300
  39.    The command will operate on the given disk numbers in order.
  40.  
  41.  A range can cover a group of disks:
  42.    ie. 214-300  or  300-214
  43.    The command will operate on all disks from 214 through 300.
  44.  
  45.  A range can also contain a mix of multiple ranges separated by a space. 
  46.    ie. 214-300 310,312 400-440 500,510
  47.    The command will operate on all disks from 214 through 300, 310,312,
  48.    all disks from 400 through 440, 500 and finally disk 510.
  49.  
  50. Example 1:
  51.  To scan the contents of the latest FredFish disks all you have to do is
  52.    use the S)earch command.  Each description will be displayed with an option
  53.    to quit or continue.  The descriptions are displayed in new to old order.
  54.  
  55. Example 2:
  56.  To find all files with `mine' in the title or description text on disks
  57.    300 to 400 all you have to do is set the SEARCH TEXT: to `mine' (without
  58.    the quotes) and set the SEARCH RANGE: to 300-400 then use the S)can command.
  59.  
  60. =======================================================================
  61.  Notes:
  62.  
  63.  To abort a search you must hold ^C down until the search stops.
  64.  
  65.  If a caller is at less than 2400 baud the current disk# only will be
  66.    displayed during a search, the row of ....... will not be displayed
  67.    which will speed things up for low baud callers.
  68.  
  69. =======================================================================
  70.  Installation:
  71.  
  72.  1 - FindFish requires one assign, add it to your startup script for CNet.
  73.  
  74.             ASSIGN FISHDATA: <where ever you put them>
  75.  
  76.      FishData: contains the ASCII data files fish0, fish1, fish2...
  77.      (see below for file format)
  78.  
  79.  2 - The FindFish program can go anywhere you want, pfiles: is a logical
  80.      location and then add it to your pfiles list as a CNet "C" Pfile
  81.      or add it to you global menu commands.
  82.  
  83.  
  84. =======================================================================
  85.  FindFish data file format:
  86.  
  87. -----------------------------------
  88. #436                               <- Fred Fish disk#
  89. filename                           <- Name of the file.
  90. n lines describing the file, taken <- Description text
  91. from the contents file included on <- each line ends with
  92. Fred Fish disks.                   <- a LF  (0x0A)
  93.                                    <- A LF in column 1 indicates end.
  94. filename
  95. n lines describing the file, taken
  96. from the contents file included on
  97. Fred Fish disks.
  98.  
  99. #437
  100. filename
  101. n lines describing the file, taken
  102. from the contents file included on
  103. Fred Fish disks.
  104.  
  105. -----------------------------------
  106.   Each data file contains the contents text for 100 Fish Disks.
  107.  
  108.   fish0 contains disks 1 to 99.
  109.   fish1 contains disks 100 to 199.
  110.   fish2 contains disks 200 to 299.
  111.   and so on.
  112.  
  113.   FindFish will handle up to 9,999 Fred Fish disks (fish99).
  114.  
  115.   The current database files include disks up to #860, you will have
  116. to manually append new data as Fred releases new disks or download the
  117. latest database files from the support BBS (see below).
  118.  
  119. ************
  120. * WARNING! *
  121. ************
  122.   The # character is reserved as an indexing marker and can only appear
  123.   as the identifier preceding the disk number.  You must scan any text
  124.   that you add to the database files and change any # characters to some
  125.   other character or delete them.  If there are any stray # characters
  126.   in the file, you are asking for trouble.
  127.  
  128.  
  129. =======================================================================
  130.  
  131.                         FindFish.c V2.0
  132.  
  133.                   CNet C Pfile for CNet V2.63+
  134.  
  135.                   Copyright © 1993 Alan Kramer
  136.  
  137.               This version is freely distributable.
  138.  
  139. =======================================================================
  140.   FindFish has been extensively tested on an A-4000 and an A-1000,
  141. with AmigaDos V3.1 and V2.04 running CNet V2.63.
  142.  
  143.  
  144. I am interested in any problems found or improvement requests.
  145.  
  146. I can be reached via:
  147.  
  148.                 Medicine Hat AMIGA Users Group BBS
  149.  
  150.                           (403)528-2060
  151.  
  152.                        14400 SUPRA V.32bis
  153.  
  154.  
  155.   FW BBS would be the next best place, I call every other week or so.
  156.  
  157. =======================================================================
  158.  
  159.   FindFish improvements:
  160.  
  161.   - The search routines have been reworked, this doubles the speed of
  162.     the text searches.
  163.  
  164.   - Release of a version compiled for the 020, 030, 040.  Should make it
  165.     even faster.
  166.  
  167.   - The ability to search through those large CDROM file listings generated
  168.     from many CDROM disks.  You will have the ability to generate your own
  169.     lists as well.
  170.  
  171.   - Any features that you would like to see implemented.
  172.  
  173. To receive the latest REGISTERED version of FindFish (V2.1) mail $7.00 to:
  174.  
  175.           Stallion Systems
  176.           Attn: Alan Kramer
  177.           1936 - 3rd Ave NE
  178.           Medicine Hat, Alberta
  179.           Canada
  180.           T1C 1C5
  181.  
  182. =======================================================================
  183. End of doc.
  184.